home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / ansi / captur2a.zip / CAPTURE.DOC < prev    next >
Text File  |  1993-08-20  |  11KB  |  265 lines
  1. CAPTURE IT! by Henrique Avila Vianna                   Version 2.1a  20/Aug/93
  2. ------------------------------------------------------------------------------
  3.  
  4.                     D O C U M E N T A T I O N   F I L E
  5.  
  6. | New features and changes in this revision are indicated by a vertical bar
  7. | at the left margin.
  8.  
  9. Introduction
  10. ------------
  11.  
  12.      Can't you get that great picture of your favorite game? If your screen
  13. grabber is not as powerful as you need, don't worry... Capture It! has arrived
  14. to save you!
  15.  
  16.      The ordinary screen capture utilities use the keyboard interrupt to copy
  17. the screen when you press a hotkey. The problem is that the latest games
  18. intercept INT 09 (the keyboard interrupt), what prevents the grabber from
  19. receiving keyboard commands.
  20.  
  21.      Capture It! has an exclusive timer system that captures the video memory
  22. contents automatically every "x" seconds! You are still able to get the screen
  23. manually, using the hotkey CTRL-ALT-C.
  24.  
  25.      The program currently captures graphic screens of the following modes:
  26.  
  27.          Hercules     720x348 monochrome
  28.          CGA          320x200 4 colors
  29.          CGA          640x200 2 colors
  30.          EGA/VGA      320x200 16 colors
  31.          EGA/VGA      640x350 16 colors
  32.          VGA          640x480 16 colors
  33.          VGA/MCGA     320x200 256 colors
  34.  
  35.  
  36. How does it work?
  37. -----------------
  38.  
  39.      Capture It! is a TSR (Terminate-and-Stay-Resident) program. Once installed
  40. it runs in background waiting for a request to get the screen (when you press
  41. the hotkey or the specified time interval has been reached).
  42.  
  43.      While resident, Capture It! uses about 9 kbytes of memory and it CAN be
  44. loaded high, if you have an expanded memory manager and you need as much base
  45. memory as possible.
  46.  
  47.      The syntax is:
  48.  
  49.          CAPTURE <path> [ <time> <number_of_screens> ]
  50.  
  51.          <path> - The path where the captured screens are to be saved.
  52.                   This item is required.
  53.  
  54.          <time> - Time in seconds between each screen captured.
  55.                   This item is optional. If not specified, the program will
  56.                   capture the screen only when you press CTRL-ALT-C.
  57.  
  58.          <number_of_screens> - Maximum number of screens that should be captured
  59.                   by the program. Useful to avoid filling up your disk with
  60.                   dozens of screens! If you use the <time> parameter, you must
  61.                   specify the <number_of_screens>.
  62.                   The maximum <number_of_screens> is 255.
  63.  
  64.      Examples:
  65.  
  66.          capture E:
  67.               captures the screen when the hotkey is pressed and save
  68.               the files in the current directory of drive E:
  69.  
  70.          capture D:\GRAPHICS\PICTURES\ 10 20
  71.               captures the video contents every 10 seconds, or when the
  72.               hotkey is pressed. A maximum of 20 screens will be captured,
  73.               and the files will be saved in d:\graphics\pictures\
  74.               (DON'T FORGET THE LAST BACKSLASH!)
  75.  
  76.          capture  OR  capture /?
  77.               will show you a brief help text.
  78.  
  79.  
  80.      The program will only capture the screen if the video mode at the moment
  81. of the capture request is one of the valid modes (see above). Otherwise, the
  82. request will be noted down and, as soon as the video mode is set properly, it
  83. will be attended. When the screen is captured and saved successfully, the PC
  84. speaker beeps twice.
  85.  
  86.      The captured screens are saved in files named PICTxxx.CAP (where xxx is
  87. a number from 1 to 255).
  88.  
  89.      After capturing all the screens you want, press CTRL-ALT-R at the DOS
  90. prompt to uninstall Capture It! from memory. If you want to change any
  91. parameter (such as the time, or number of screens) you will also have to
  92. uninstall the previous installed copy, and install it again with the new
  93. parameters.
  94.  
  95.      ATTENTION! When you install a new copy of Capture It!, it starts saving
  96. the screens as PICT1.CAP. So, you must rename previous captured files to
  97. prevent the program from rewriting them.
  98.  
  99.  
  100. Now what?
  101. ---------
  102.  
  103. |    The Capture It! files are saved in an uncompressed form, to speed up the
  104. | capturing process, but these .CAP files are not a standard format. Well, at
  105. | least the CGA captured screens can be BLOADed via BASIC. :) :)
  106. |
  107. |    But..... thanks to Oliver Fromme you can now convert these .CAP files to
  108. | the great (and well-known) GIF format.
  109. |    There are two ways to do it:
  110. |          - using directly the command-line driven CAP2GIF program (please
  111. | refer to the CAP2GIF.DOC file for instructions);
  112. |          - or using SCReen LoaDer that lets you view and choose the pictures
  113. | you want to convert to GIF (if you are capturing by time you'll propably get
  114. | some undesired screens, so SCRLD lets you also delete files).
  115.  
  116.      The SCRLD syntax is:
  117.  
  118.          SCRLD [<path>] [/T<time>] [/F] [/L]
  119.  
  120.          <path> - Path where to search for the .CAP files.
  121.                   If not specified assumes the current path.
  122.  
  123.          <time> - Time in seconds between each picture shown.
  124.                   If not specified waits for a keypress to change file.
  125.  
  126.          /F     - If specified, uses fade effects between screens (VGA only).
  127.  
  128.          /L     - If specified, turns on loop. Use ESC to quit.
  129.  
  130. |    While viewing a picture, the following command keys are available:
  131. |        G key  - Calls the CAP2GIF program to save the picture as a .GIF file
  132. |        D key  - Deletes the picture.
  133. |    Using the /T<time> option disables the above keyboard commands.
  134. |
  135. | PLEASE NOTE THAT CAP2GIF AND SCRLD PROGRAMS *MUST* BE IN THE SAME DIRECTORY
  136.  
  137.      Examples:
  138.  
  139.          scrld
  140.               displays all .CAP files in the current drive and directory
  141.  
  142.          scrld F:\
  143.               displays all .CAP files in the root of drive F:
  144.  
  145.          scrld D:\GRAPHICS\TEMP\ /T5 /F /L
  146.               displays all .CAP files in d:\graphics\temp\ with an interval
  147.               of 5 seconds between each one. Uses fade in and fade out effects,
  148.               and stays in loop until the ESC key is pressed.
  149.  
  150.          scrld /?
  151.               shows a brief help text.
  152.  
  153.      SCRLD can also read standard BASIC BSAVED screens (CGA only).
  154.  
  155.  
  156. Known problems
  157. --------------
  158.  
  159.      As you know, MS-DOS isn't a multi-task environment. TSR applications run
  160. in background, using hardware interrupts to have the processor's attention.
  161. These applications are somewhat "intruders" in the system, and may not run
  162. properly all the time.
  163.  
  164.      After capturing a screen, Capture It! may cause the system to hang up, or
  165. may confuse the screen display. In both cases, the first screen captured must
  166. be ok, so you may need to quit the game and run it again to get more screens.
  167. (Using a RAM drive to store the captured screens may be not a good idea if you
  168. have to reset the system!).
  169.  
  170.      If you are capturing manually, try not to use the hotkey during long disk
  171. transfers, specially if you are running from floppies.
  172.  
  173.      Only uninstall the program at the DOS prompt. If you use CTRL-ALT-R to
  174. uninstall Capture It! while running another program it will abort and the
  175. system may hang up or become unstable.
  176.  
  177.      Remove unnecessary TSR programs while using Capture It!. Two or more TSR
  178. applications may be incompatible with each other.
  179.  
  180.      Some programs may access the video board in a non-standard way in some
  181. video modes. Newer games access the VGA 256-color mode differently from the
  182. MCGA, what causes most of screen capture utilities to read the video information
  183. incorrectly. Version 2.1 of Capture It! corrects this problem. Anyway, if you
  184. get a distorted image of the captured screen, try using another video
  185. configuration in your program.
  186.  
  187. |    A friend reported me problems using the Write Cache of SMARTDRV (the
  188. | screens didn't get saved). I personally use only the Read Cache and it
  189. | works fine.
  190. |
  191. |    Attention EGA card owners:
  192. |          - Screens captured on EGA cards won't be correctly displayed by
  193. | SCRLD on a VGA card; convert them to GIF to assure compatibility.
  194. |          - Screens captured on EG